package com.vehiclemanagement.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.vehiclemanagement.entity.ETCPassage;

import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * ETC通行记录服务接口
 */
public interface ETCPassageService extends IService<ETCPassage> {
    
    /**
     * 分页查询ETC通行记录
     * 
     * @param current 当前页
     * @param size 每页记录数
     * @param searchTerm 搜索关键词
     * @param vehicleId 车辆ID（可选）
     * @param etcCardId ETC卡ID（可选）
     * @param passageType 通行类型（可选）
     * @param status 状态（可选）
     * @param startTime 开始时间（可选）
     * @param endTime 结束时间（可选）
     * @return 分页结果
     */
    IPage<ETCPassage> pagePassages(Integer current, Integer size, String searchTerm, 
                                  Long vehicleId, Long etcCardId, Integer passageType, Integer status,
                                  LocalDateTime startTime, LocalDateTime endTime);
    
    /**
     * 根据ID获取通行记录
     * 
     * @param id 通行记录ID
     * @return 通行记录
     */
    ETCPassage getPassageById(Long id);
    
    /**
     * 添加通行记录，同时更新ETC卡余额
     * 
     * @param passage 通行记录
     * @return 是否成功
     */
    boolean addPassage(ETCPassage passage);
    
    /**
     * 更新通行记录
     * 
     * @param passage 通行记录
     * @return 是否成功
     */
    boolean updatePassage(ETCPassage passage);
    
    /**
     * 删除通行记录
     * 
     * @param id 通行记录ID
     * @return 是否成功
     */
    boolean deletePassage(Long id);
    
    /**
     * 结算通行记录（变更状态为已结算）
     * 
     * @param id 通行记录ID
     * @return 是否成功
     */
    boolean settlePassage(Long id);
    
    /**
     * 批量结算通行记录
     * 
     * @param ids 通行记录ID列表
     * @return 成功结算的记录数
     */
    int batchSettlePassages(List<Long> ids);
    
    /**
     * 统计某辆车的总通行费用
     * 
     * @param vehicleId 车辆ID
     * @return 总通行费用
     */
    BigDecimal sumFeeByVehicleId(Long vehicleId);
    
    /**
     * 统计某张ETC卡的总通行费用
     * 
     * @param etcCardId ETC卡ID
     * @return 总通行费用
     */
    BigDecimal sumFeeByEtcCardId(Long etcCardId);
    
    /**
     * 月度通行费用统计
     * 
     * @param year 年份
     * @return 月度统计数据
     */
    List<Map<String, Object>> statisticsByMonth(Integer year);
    
    /**
     * 通行类型统计
     * 
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 通行类型统计数据
     */
    List<Map<String, Object>> statisticsByPassageType(LocalDateTime startTime, LocalDateTime endTime);
} 